v7.19.0: released

Compare Source

v7.19.0 stable release comes with 60+ enhancements, bug fixes. Once again thanks for all the contributions from the community.

Below are the highlights of the changes. For a full list of changes, please refer to the "Pull Request" tab.

General

• Update parser to newer version v2.1.37 #​22729
• Fix DevContainer by switching from moby to docker #​22725
• Resolve vendor extensions on schemas referenced in parameters #​22690
• Better null check in normalizeSchema #​22671
• [Fix] [Regression] Resolve the discriminator type from a 3.1 sibling #​22634

C#

• [REQ][CSHARP] Make TokenProvider abstract method GetAsync protected for override #​22615

C++

• [cpp] Fix Nested Map & Additional Properties Support #​22639

Crystal

• [CRYSTAL] object_id method should be a reserved words #​22577

Go

• [go] fix default value for array type #​22584

Java

• [Java][Native] Fix request compression #​22688
• fix: [JAVA][SPRING] Nullaways warn with JSpecify => add missing annotation to parameter of method toIndentedString #​22685
• [BUG][JAVA][SPRING] api util must test variable nullity #​22679
• [java][jackson] fix: conditionally add jackson JsonIgnoreProperties for base class polymorphism #​22528

Kotlin

• [kotlin-spring] Revert nested property placeholder in @​RequestMapping that Spring cannot resolve #​22625

Nim

• [Nim] Fix nested map support #​22643

PHP

• [php][php-nextgen] Mark nullable things as nullable in phpdoc #​22650

ProtoBuf

• [Protobuf] Improve oneOf Handling by Unwrapping allOf for Complex Types #​22700

Python

• Update python fastapi urllib3 to newer version #​22644

R

• [R] fix error handling in the R client #​22704
• [R] fix set[object] deserialization #​22697

Rust

• Refresh dependencies in the Rust server generator #​22710
• [Rust] Enum Query Parameter Serialization Fixes #​22683

Swift

• [swift][client] Update CI to use Xcode 26 #​22648
• Fix Swift oneOf discriminator decoding with enumUnknownDefaultCase #​22635
• [Swift6] Remove ParameterConvertible for models #​21150

TypeScript

• fix(typescript-axios): Add missing import in case of separate models and API #​22712
• [typescript-axios] Handle sets as arrays in input parameters #​22642
• feat(typescript-angular): add angular 21 support #​22636

v7.18.0: released

Compare Source

v7.18.0 stable release comes with 70+ enhancements, bug fixes. Once again thanks for all the contributions from the community.

Below are the highlights of the changes. For a full list of changes, please refer to the "Pull Request" tab.

General

• feat: prevent variable resolution when prefixed with $ in server URL templates #​22550
• Fix siblings of $ref using allOf in openapi normalizer #​22364

C++

• fix(cpp-qt): Fix enum query parameter serialization for both inline and referenced enums #​22559
• [cpp-rest] Fixes segfault for nullable strings #​22405
• Add Basic and Bearer Authorization to the CPP Pistache generator #​22337
• Fixes oatpp generator to expose network server on 0.0.0.0 instead of localhost #​22330
• [cpp-rest] Fixing Incorrect Header Name Used #​22298

C#

• [csharp] Patch dependencies with vulnerabilities #​22262

Crystal

• fix(generator): fix java.lang.NullPointerException in constructing example code #​22545
• [crystal] fix Model#to_h method #​22508
• [crystal] Add option to set params_encoder #​22484
• [crystal-lang] Various fixes for Crystal client #​22465

Go

• [GO] Generate imports for UnmarshalJSON func only when it's present #​22524
• fix: missing imports for array of files and date-time parameters #​22390

Java

• [BUG][JAVA][Spring] fix Lombok @​Getter disables validation #​22544
• Fix Spring Framework 7 compatibility in jvm-spring-restclient and jvm-spring-webclient #​22467
• [Java] Support JsonNullable in JaxRS-spec #​22412
• [JAVA][native] Add support for UnaryInterceptors #​22381
• Add support for custom tls server names. #​22372
• [JAVA] [NATIVE] Add gzip capability #​22358
• [Java] Use Fully Qualified Name for java.util.Locale in Generated Classes #​22342
• [JAXRS] Partial revert changing path generation if interface, fixes #​22279 #​22316
• [JAVA jaxrs-spec gen] add option for generating swagger V3 annotations #​22300
• [REQ-22001] Add MCP server support to apiService.mustache #​22197

Kotlin

• fix(kotlin): add JsonCreator/JsonValue to Jackson enums #​22535
• [kotlin][client] Deprecate jvm-volley support #​22521
• [kotlin] fix query parameter encoding #​22512
• [kotlin-client] Vert.x: Fix enum class name template for default operation parameters #​22504
• [kotlin] Make API classes open (non-final) unless nonPublicApi is used #​22461
• [kotlin-spring][server] Feat: Return from controllers without ResponseEntity wrapper #​22377
• Add support for oneOf with discriminator when using kotlinx.serialization #​22373
• Fix Kotlin codegen for enum with int items (issue #​15204) #​22324
• [kotlin-spring][server] Feat: Add Spring Declarative HTTP Interface support for easy client instantiation #​22302

Nim

• [nim] Nim Generator Fixes #​22385

PHP

• [php][php-nextgen] Cleanup api authentication code when using api keys in cookies or supporting multiple authentication methods #​22433
• [php][php-nextgen] fix return type if empty and non-empty responses are mixed #​22322
• [php][php-nextgen] fix array enum query parameters #​22320
• [php] Fix PHP generator validation for nullable required properties #​22292

ProtoBuf

• [Protobuf] Add isEnumSchema check in generateNestedSchema #​22384

Python

• python-fastapi: avoid log message in constructor #​22522
• Make python code compatible with urllib3 v2.6.0+ #​22520
• fix: use httpx in generated configuration.py #​22418
• [python] Fix pyproject (poetry 2.x) for httpx #​22289

Ruby

• [Ruby] Fixes anyOf Support in Responses #​22392

Rust

• [rust-server] feat: Add serde_validate support #​22553
• Update rust-server Cargo.toml to fix client feature compile #​22511
• fix: Rust-server bytes response fixed to not attempt string conversion #​22471
• [Rust-Axum] FIX: do not generate Partial Ord/Ord for Any type #​22469
• [Rust] Implement support for multipart file uploads for reqwest-async and reqwest-trait #​22454
• Ensure rust-server compiles with no-default-features #​22445
• Add support for trait mocking in rust-server generator #​22332
• Fixups for rust-server hyper1 support #​22321
• [Rust-Axum] Fix: incorrect regex pattern validation #​22277

Scala

• Fixed scala-sttp4-jsoniter compilation error: replace .getRight with .orFail #​22536

TypeScript

• [typescript-fetch]: fix logic when stringEnums is explicitly set to false #​22466
• Typescript-Angular: Fix several query parameters serialization issues #​22459
• [typescript-rxjs] Feat: Add @​deprecated JSDoc tag to API operations #​22419
• [typescript-nestjs-server] Fix #​21842 by updating api.module.mustache #​22403
• [typescript-node] Fixes generation when parent contains TypeScript primitive #​22401
• [typescript] replace headers with same case-insensitive key to match http spec #​22393
• [typescript-axios] add support for accept headers #​22318
• fix: Format Date/DateTime Query Parameters in exploded, non-container Parameter #​22268

v7.17.0: released

Compare Source

v7.17.0 stable release comes with 60+ enhancements, bug fixes. Once again thanks for all the contributions from the community.

This release comes with 1 breaking change (with fallback):

• Set REFACTOR_ALLOF_WITH_PROPERTIES_ONLY to true by default (Breaking change (with fallback)) #​22180

Below are the highlights of the changes. For a full list of changes, please refer to the "Pull Request" tab.

General

• openapi-normalizer: Add REMOVE_PROPERTIES_FROM_TYPE_OTHER_THAN_OBJECT normalize option #​22236
• Set REFACTOR_ALLOF_WITH_PROPERTIES_ONLY to true by default (Breaking change (with fallback)) #​22180
• OpenApiNormalizer FILTER improvements. Multi filters + filter on path #​22128
• Fix additional properties handling in 3.1 spec #​22056

C

• Update c curl generator to support float #​21103

C#

• [CSHARP] Add cache to efficiently lookup CodegenModel in csharp codegen to make csharp generator faster #​22094
• [CSHARP] Fix how the array type is set when using NULLABLE_REFERENCE_TYPES #​22071
• [csharp][httpclient] do not use deprecated HttpRequestMessage.Properties #​20737

Dart

• [dart] Fix compile error in inline enum properties with "default" values #​22165

Elixir

• [fix][elixir] missing type mapping for AnyType #​22081

Java

• [jaxrs] Support jackson option (true by default) #​22169
• [Java][jaxrs-spec] withXml support #​22140
• Jersey2/3: Fixes a bug in OAuth token renewal, where the previous HTTP 401 code is reused even after the retry succeeds #​22134
• [Spring] Remove unnecessary modifiers from API interface templates #​22132
• Custom error messages for size, length, min & max validations in Spring & Spring-Kotlin #​22090
• Spring 7 WebClient Compatibility #​22030
• [Spring] add support for api versioning #​22028

Julia

• [Julia] Fix docstring parameter formatting with backticks #​22190

Kotlin

• Custom error messages for size, length, min & max validations in Spring & Spring-Kotlin #​22090

PHP

• Expose mtls certificate config params in python and php configuration templates #​22229
• fix(php,php-nextgen): remove useless string cast from ObjectSerializer.mustache #​22121

Python

• Expose mtls certificate config params in python and php configuration templates #​22229
• [python-fastapi] Fix: Skip sorting of path operations #​22166

Ruby

• [ruby] Introduce ApiModelBase to reduce code duplication #​22052

Rust

• [rust-axum] don't include quotes in output string from Display trait for string types #​22161
• [Rust-Axum] Fix wrong validation for non-model Body #​22155
• feat(rust-axum): make the Object value public #​22144
• Removed a duplicate binding for an address for rust-server #​22116

TypeScript

• [Typescript-fetch] Add isBoolean blocks to modelOneOf.mustache #​22220
• [typescript-axios] Add support for AWSv4 Signature #​22174
• fix: typescript docs not being put in a docs directory #​22124
• feat(typescript-fetch): add docs support #​22110
• [typescript-fetch] Fix infinite recursion with self-referencing discriminator mappings #​21956

v7.16.0: released

Compare Source

v7.16.0 stable release comes with 100+ enhancements, bug fixes. Once again thanks for all the contributions from the community.

The community also contributed 3 new generators in this release:

• [python] add async httpx support Client: Python #​22021
• feat: Add Java Dubbo code generator for Apache Dubbo microservices #​21968
• New generator for Scala3 + sttp4 + jsoniter-scala #​21908

Below are the highlights of the changes. For a full list of changes, please refer to the "Pull Request" tab.

General

• Update commons related dependencies to newer versions #​21980
• Correctly annotate Gradle task in- & outputs and enable stricter plugin validation #​21957
• Support normalizing anyof/oneof enum constraints to a single enum #​21917
• feat: add support for minimal-update option in maven plugin #​21872
• Update swagger parser to 2.1.32 #​21818
• Fix bug in ModelUtils.getParentName resulting in wrong inner Models for oneOf-composed schemas #​21799
• [3.1] Fixed lack of check for booleanSchemaValue #​21742

Bash

• [bash] Drop old client.sh from petstore sample #​21987
• [bash] Fix issue where paste command doesn't work on Mac #​21986

C#

• Fix visibility for enum in C# generator #​21984
• [C#] Fixes array TypeDeclaration parsing order to fix deep aliases #​21600

Dart

• [dart-dio][timemachine] Bugfix: saving offset_date_serializer instead of local_date_serialize #​21974
• Add skipCopyWith option for dart-dio #​21816

Kotlin

• fix(kotlin-spring): add missing constructor parentheses for hashmap models #​22029
• [kotlin] Fix enum defaultValue in query parameters with schema reference #​22002
• [kotlin][client] remove old deprecated apis #​21988
• [kotlin-spring][server] Feat: Allow implementation of arbitrary interface in DTOs (similar to x-implements from java-spring) #​21950
• Fix missing @​Serializable on enums for kotlin/jvm-retrofit2 #​21907
• [kotlin-client] Fix string comparison in discriminator post-processing #​21881
• [kotlin-client] update Kotlin and libraries versions #​21866
• Kotlin Multiplatform polymorphism with custom discriminator support #​21772

Go

• go: Fix missing imports for optional body params #​22014
• feat(golang): support for wrapped and xml name #​21899

Java

• [JAVA] Add vendorExtensions.x-class-extra-annotation to oneOf interfaces #​22020
• [cxf] add support for Swagger2 #​22010
• [java] Fix annotationLibrary option being ignored #​21992
• [Java] [Spring-client] Exclude discriminator from nullable annotation #​21981
• feat: Add Java Dubbo code generator for Apache Dubbo microservices #​21968
• [jaxrs-spec][quarkus] Feat: Add an option to use "org.jboss.resteasy.reactive.RestResponse" #​21877
• [Java] [Spring] Use deduction configOptions for oneOfInterfaces #​20919

OCaml

• [Fix][OCaml] Incorrect encoding/decoding for required free-form objects; Odoc for record fields #​21819
• [OCaml] Generate .ocamlformat file; format all generated OCaml files #​21809
• [OCaml] Introduce support for oneOf/anyOf, fix default value for non-required maps #​21798

PHP

• Fix php-slim4 API key authentication throwing exception #​21962
• Setup void type for PHP Symfony CompilerpassInterface #​21808
• [php] Fixed typing of offsetGet/offsetSet/offsetUnset #​21583

ProtoBuf

• [protobuf] fix generation of enums with UNSPECIFIED values #​21774

Python

• [python] add async httpx (new library option) support #​22021
• [python] api client type checks #​21935
• fix(python): update pyproject.toml license format with poetry1 fallback #​21931
• [python] fix default value when enum is a reference #​21923
• python: feature flag for lazy imports #​21885

Ruby

• fix(ruby-client): Fix incorrect boolean parsing in OneOf/AnyOf #​21943

Rust

• [Rust-Axum] Support AnyOf, AllOf #​21948
• [Rust] Add support for native-tls and rustls-tls Cargo features for the reqwest library #​21925
• [BUG][rust-axum] Fix duplicate route operations when supplying multiple tags on a path with a camelCase param #​21873
• [rust] set useAsyncFileStream only for files in the body #​21839

Scala

• Mark scala-lagom-server as deprecated #​21977
• New generator for Scala3 + sttp4 + jsoniter-scala #​21908

Swift

• [Swift6][client]Make Swift 6 generator stable #​21846

TypeScript

• [typescript-axios]: withSeparateModelsAndApi handles importFileExtension #​22032
• [Typescript] add missing typeRoots config on tsconfig #​21824
• typescript-fetch: Fix model date crash #​21821

v7.15.0: released

Compare Source

v7.15.0 stable release (breaking changes with fallbacks) comes with 140+ enhancements, bug fixes. Once again thanks for all the contributions from the community.

This release comes with 1 breaking change (with fallback):

• [rust-server] Update to hyper1 in rust-server generator #​21422

The community also contributed 3 new generators in this release:

• [C++] [Client] Added cpp-oatpp-client #​21711
• Add cpp-oatpp-server generator (alpha) #​21547
• NestJS server codegen #​21494

Below are the highlights of the changes. For a full list of changes, please refer to the "Pull Request" tab.

General

• Bugfix for remote specs with params #​21634
• [gradle-plugin] add treatWarningsAsErrors option to openApiValidate in gradle plugin #​21626
• Fix response model generation with ParseOptions.resolveResponses=true #​21568
• [req] Allow models and apis list properties to span multi-lines #​21536
• Bump jmustache 1.15 -> 1.16 #​21352
• Add 'isFormStyle', 'isSpaceDelimited', and 'isPipeDelimited' flags to CodegenParameter #​21240
• Added symlink to generator CLI in Docker image #​15559

C

• add curl handler pre-invoke-callback to c-libcurl #​21654
• feature: Add control flag for static compile #​21635
• Add verbose, keepalive, keepidle, keepintvl to c-libcurl #​21613

C#

• [REQ] [CSHARP] [UNITYWEBREQUEST] Support Stream for unityWebRequest library #​21704
• [BUG][CSHARP][GENERICHOST] Write enum values in expected JSON format #​21698
• [csharp] Fix composed enum handling #​21690
• [csharp][generichost] Fix response testing when dataType missing #​21687
• [csharp] Ensure unique property names #​21649
• [csharp] Handle nested maps recursively #​21636
• [C++] [Client] Added cpp-oatpp-client generator #​21711

C++

• [C++] [Client] Added cpp-oatpp-client generator #​21711
• [C++] [Client] Fixes to cpp-oatpp-server generator #​21595
• Add cpp-oatpp-server generator (alpha) #​21547

Dart

• Feat: #​21665 [dart][dart-dio] CopyWith for json_serializable #​21667
• [dart-dio] Fix json_serializable response for type:string format:binary #​21379
• [dart-dio] Fix compile error in enum properties with "default" values (#​20495) #​21355

Go

• Update AWS Go SDK from v1 to v2 in Go client templates #​21653

Java

• [Java][RestClient] Generate servers for restclient library #​21699
• [spring] Adapt HttpHeaders access to remain compatible with Spring 7 #​21691
• [JAVA] Remove [this-escape] warnings in generated ApiClient classes #​21620
• [Java-Spring] add comment to EnumConverterConfiguration mustache file #​21598
• Conditional import of AtomicInteger added to delegate template #​21597
• [Java] [SpringClient] Introduce setting for sealed oneOf interfaces for Spring clients #​21586
• [okhttp-gson] Type check of array element only when array is not empty #​21571
• [Bug][java-spring] Use Flux only for multipart-form-data file parameters with multiple file uploads #​21561
• [Java][native] Add ability to add header to specific calls #​21495
• Move the singleRequestParameter template into a separate file #​21489
• [Java][MicroProfile] Support additionalProperties with Jackson #​21451
• Restricted Java oneOf imports to Jackson only when needed (#​21404) #​21405
• [JavaSpring] Allow configuring generic ResponseEntity for Spring generator #​21387
• [java][Microprofile] add config options to disable usage of ApiExceptionMapper #​20762

Kotlin

• [REQ] [CSHARP] [UNITYWEBREQUEST] Support Stream for unityWebRequest library #​21704
• kotlin-spring: fix exception thrown in enum.forValue #​21622
• [Bug][kotlin-spring] add a Spring type converter for enum values #​21579
• Kotlinx polymorphism with custom discriminator support #​21531
• [BUG][Kotlin] Fixed primitive type check for array of array #​21500
• [BUG][kotlin-spring] Fix Boolean type mismatch for kotlin-spring generator (#​21478) #​21481
• [BUG][Kotlin] fix: kotlin code generator should sanitize enum values according to convention #​21459

OCaml

• [OCaml] Derive eq #​21679

PHP

• [php][php-nextgen] add new github workflow to perform syntax check on php files #​21678
• [php] Fix file uploads (by backporting #​21458) #​21632
• fix: Use correct constructor for ApiException in PSR-18 PHP library #​21631
• Removed try/catch to enable framework error handling to pick up error #​21523
• php-nextgen - Fix flatten() to support arrays of files #​21458

Protobuf

• [Protobuf] Fix nullpointer for allOf with additionalProperties=false #​21556

Python

• python: Reinstate lazy imports #​21486

R

• [R] add null checks to nullable api parameters #​21629

Rust

• [Rust] Replace more HeaderValue::from_str with compile time from_static #​21689
• Add reqwest-trait crate to workspace and rename it #​21674
• Fixup failing CI in rust-server due to xmltree dependency #​21664
• [rust] Extend oneOf array enum names with inner type #​21599
• [Rust-Axum] Basic Authorization - Basic Analytic - XSS Sanitize #​21578
• Replace periods with underscores in Rust model names #​21480
• [rust-server] Update to hyper1 in rust-server generator (Breaking change (with fallback)) #​21422

Scala

• [Scala sttp] Fix header serialization for Optional values #​21603
• Generators "scala-sttp" and "scala-sttp4" produce valid code when using APIKeyQuery, APIKeyHeader and APIKeyCookie #​21551
• [scala][http4s] fix escaping of reserved words for correct model property names #​21518
• [scala][http4s] fix codegen for using reserved words in openapi #​21490

Swift

• [swift] [urlsession] Fixes crash for uploads with content-type "image/" #​21544
• [Swift5][Swift6] support "x-enum-descriptions" #​21706

TypeScript

• feat(typescript-angular): prepare build #​21684
• [BUG][typescript-fetch] Default case for oneOf serialization method returning undefined variable. #​21669
• [Bug][typescript-fetch] Typescript fetch one of addtl props imports #​21656
• [Bug][typescript-fetch] Fix missing close parenthesis in oneOf models #​21645
• [test][typescript-fetch] Add / improve unit tests for current typescript-fetch oneOf logic #​21638
• [typescript] Add optional erasable syntax configuration to Typescript generator #​21560
• [Typescript Fetch] Fix missing closing bracket in date handling #​21549
• Followup fix for importFileExtension config for typescript-axios #​21541
• NestJS server codegen (new generator) #​21494
• Fix typescript-fetch missing imports for oneof field with discriminator #​21477
• [typescript] Utility types now considered when generating schemas #​21414